Operator CameraRgbArea

Operator Library: Hardware Platform

This operator represents the image data interface between a RGB area scan GigE Vision camera and VisualApplets. This operator requires one VisualApplets resource of type CAM. Set the resource index for the camera in the resource dialog. The resource index 0 maps the camera to port 0, index 1 to port 1, etc. Check 'Allocation of Device Resources' for more information.

This operator can be configured to support the different data formats specified by the GigE Vision standard. The following figure illustrates the data formats.

Note

  • RGBA8_PACKED and BGRA8_PACKED transmit an alpha component. However the camera port link is specified as RGB. Therefore the alpha component (the 4th component) is cut off inside the camera port and only the other three R, G and B components are provided on the output link. If the 4th component is required, use CameraGrayArea and set the format to MONO8. The 4 provided pixels will build a single RGBA pixel. Now reinterpret the gray pixels as required.
  • The camera operator extracts and aligns pixels as needed. For example setting the format to BGR8_PACKED will force the camera operator to swap B and R components internally. At the output link a perfect RGB pixel is provided. The same applies for RGB10V1 and RGB10V2 formats. The camera operator will output 3 concatenated components.

The parameterized format is converted to match with the parameterized output link format of the camera operator. The output link can be configured to several bit widths. Conversion is performed by adding bits to the lower bit positions if the camera format bit width is higher than the parameterized bit width in the output link. However, if the camera format bit width is less than the available bits at the output link, only the most significant bits are used.

Moreover, in the output link the maximum possible image dimensions have to be specified. The size of the actual transfered images however may be less but must not exceed this parameterized maximum.

Available for Hardware Platforms
microEnable IV VQ4-GE/-GPoE

I/O Properties

Property Value
Operator Type M
Output Link O, image data output

Supported Link Format

Link Parameter Output Link O
Bit Width {24, 30, 36}
Arithmetic unsigned
Parallelism {2, 4}
Kernel Columns 1
Kernel Rows 1
Img Protocol VALT_IMAGE2D
Color Format VAF_COLOR
Color Flavor FL_RGB
Max. Img Width any
Max. Img Height any

Parameters

PixelFormat
Type dynamic read/write parameter
Default RGB8_PACKED
Range {RGB8_PACKED, BGR8_PACKED, RGBA8_PACKED, BGRA8_PACKED, RGB10_PACKED, BGR10_PACKED, RGB12_PACKED, BGR12_PACKED, RGB10V1_PACKED, RGB10V2_PACKED}

This parameter specifies the data format of the connected camera. The format has to match with the camera configuration.

Examples of Use

The use of operator CameraRgbArea is shown in the following examples: